The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
api-docs-tooling	Ready	Preview	Jul 19, 2026 9:56am

PR Summary

Low Risk
CLI-only configuration discovery with well-tested precedence; no auth, security, or data-path changes.

Overview
doc-kit generate now loads project config without --config-file. When that flag is omitted, createRunConfiguration uses cosmiconfig to look in process.cwd() only (searchStrategy: 'none') for the first supported doc-kit.config.* among .js, .cjs, .mjs, .ts, .cts, and .mts, loading via the existing importFromURL path. If nothing is found, behavior stays the same as before: an empty object, then CLI flags and defaults.

--config-file still wins — explicit paths skip cosmiconfig and go through loadConfigFile as before. The cosmiconfig dependency is added to support discovery and parsing.

Tests cover auto-detection wiring, explicit-path precedence, the no-file fallback, and importing type-strippable .ts/.cts/.mts config files through importFromURL.

^{Reviewed by Cursor Bugbot for commit ed0755a. Bugbot is set up for automated code reviews on this repo. Configure here.}

Thanks for the specific direction, @AugustinMauroy and @avivkeller. I have updated and rebased the branch to cover the full supported configuration-file set.

When --config-file is omitted, discovery now checks this exact priority order:

1. doc-kit.config.js
2. doc-kit.config.cjs
3. doc-kit.config.mjs
4. doc-kit.config.ts
5. doc-kit.config.cts
6. doc-kit.config.mts

The first existing file wins. An explicit configFile still bypasses discovery, JSON is not included because it is unsupported, and the no-file behavior remains unchanged.

Coverage now includes:

• all six discovered filenames;
• exact probe order and first-match priority;
• explicit-path precedence;
• no-file fallback;
• native loading for TypeScript, CommonJS TypeScript, and ES module TypeScript configurations.

Local verification on current upstream main b9750dc:

• focused configuration and loader tests: 34 passed
• full test suite: 529 passed, 0 failed
• lint: 0 errors; 2 pre-existing unrelated warnings
• format check: passed
• diff check: passed

I also checked the still-open dynamic-configuration PR #905. It touches the same configuration area but implements dynamic default values, so there is no semantic overlap with this file-discovery correction at present.

The updated head is 662687f. Could you please take another look when CI is ready?

I feel like a dep like cosmiconfig does this for us?

Didn't mean to close! Feel free to iterate based on my feedback

Thanks — that makes sense. I have reworked the revision locally to use cosmiconfig for discovery instead of maintaining the file-probing logic ourselves. The explorer is configured for the current working directory and the agreed six doc-kit.config.* names, in priority order; an explicit --config-file still bypasses discovery, and the existing loader remains responsible for JavaScript and TypeScript module loading.

Local verification is green: focused configuration tests 17/17, full suite 527/527, six-extension plus priority smoke check passed, lint has 0 errors (2 pre-existing unrelated warnings), and formatting passed. I have not updated the PR head yet.

Can you push those changes?

Thanks — I’ve pushed the cosmiconfig revision in ed0755a.

Configuration discovery is now scoped to the current working directory and uses the agreed priority order for doc-kit.config.js, .cjs, .mjs, .ts, .cts, and .mts. An explicit --config-file still bypasses discovery.

Validation after the update:

• focused configuration tests: 17/17 passed
• full test suite: 527/527 passed
• lint: 0 errors (2 pre-existing unrelated warnings)
• formatting: passed
• real-file smoke test: all six extensions and first-match priority passed

Please take another look when convenient.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 85.17%. Comparing base (4534824) to head (ed0755a).
⚠️ Report is 1 commits behind head on main.

@@            Coverage Diff             @@
##             main     #901      +/-   ##
==========================================
- Coverage   86.17%   85.17%   -1.01%     
==========================================
  Files         188      192       +4     
  Lines       17146    17575     +429     
  Branches     1540     1565      +25     
==========================================
+ Hits        14776    14969     +193     
- Misses       2363     2599     +236     
  Partials        7        7              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.